home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / u_man / cat1 / split.z / split
Encoding:
Text File  |  2002-10-03  |  4.9 KB  |  133 lines
  1.  
  2.  
  3.  
  4. sssspppplllliiiitttt((((1111))))                                                              sssspppplllliiiitttt((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _ssss_pppp_llll_iiii_tttt - split a file into pieces
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      _ssss_pppp_llll_iiii_tttt [_----_llll_l_i_n_e__c_o_u_n_t] [_----_aaaa_s_u_f_f_i_x__l_e_n_g_t_h] [_f_i_l_e [_n_a_m_e]]
  13.      _ssss_pppp_llll_iiii_tttt _----_bbbb_n[k|m] [_----_aaaa_s_u_f_f_i_x__l_e_n_g_t_h] [_f_i_l_e [_n_a_m_e]]
  14.      _ssss_pppp_llll_iiii_tttt [ _----_l_i_n_e__c_o_u_n_t ] [ _f_i_l_e [ _n_a_m_e ] ]
  15.  
  16. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  17.      _ssss_pppp_llll_iiii_tttt reads an input _f_i_l_e and writes it in one or more output files. The
  18.      default size of each output file is 1000 lines. The size of the output
  19.      files can be modified by _----_bbbb and _----_llll options. Each output file is created
  20.      with a unique suffix. The suffix consists of exactly _s_u_f_f_i_x__l_e_n_g_t_h
  21.      lower-case letters from locale. The letters of the suffix are used as if
  22.      they were a base-26 digit system, with the first suffix to be created
  23.      consisting of all a characters, the second with a b replacing the last a,
  24.      and so sorth, until a name of all z characters is created. By default,
  25.      The names of the output files are x, followed by a two-character suffix
  26.      from the character set as described above, starting with aa, ab, ac, and
  27.      so forth, and continuing until the suffix zz, for a maximum of 676 files.
  28.  
  29.      If the number of files required exceeds the maximum allowed by the suffix
  30.      length provided, such that the last allowable file would be larger than
  31.      the requested size, _ssss_pppp_llll_iiii_tttt will fail after creating the last file with a
  32.      valid suffix; it will not delete the files it created with valid
  33.      suffixes.  If the file limit is not exceeded, the last file created will
  34.      contain the remainder of the input file, and may be smaller than the
  35.      requested size.
  36.  
  37.      _f_i_l_e is the pathname of the file to be split. If no file is given or _f_i_l_e
  38.      is _----, the standard input will be used. _n_a_m_e is the prefix to be used for
  39.      each of the files resulting from the split operation. If not given, x
  40.      will be used as the prefix of the output files.
  41.  
  42. OOOOPPPPTTTTIIIIOOOONNNNSSSS
  43.      _----_aaaa_s_u_f_f_i_x__l_e_n_g_t_h
  44.           Use _s_u_f_f_i_x__l_e_n_g_t_h letters to form the suffix portion of the
  45.           filenames of the split file. Default suffix length is 2. If the sum
  46.           of _n_a_m_e and _s_u_f_f_i_x__l_e_n_g_t_h option-argument would create a filename
  47.           exceeding NAME_MAX bytes, _ssss_pppp_llll_iiii_tttt will exit with a diagnostic message
  48.           and no files will be created.
  49.  
  50.      _----_bbbb_n[k|m}
  51.           Specify the output file size in bytes _n. With k specified, an output
  52.           file is n*1024 bytes in size;with m specified, a file is n*1048576
  53.           bytes in size.
  54.  
  55.      _----_llll_l_i_n_e__c_o_u_n_t or _----_l_i_n_e__c_o_u_n_t
  56.           Specify the number of lines in each output file. _l_i_n_e__c_o_u_n_t is an
  57.           unsigned decimal integer. The default is 1000. If the input does not
  58.           end with a newline character, the partial line will be included in
  59.           the last ouput file.
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. sssspppplllliiiitttt((((1111))))                                                              sssspppplllliiiitttt((((1111))))
  71.  
  72.  
  73.  
  74. FFFFIIIILLLLEEEESSSS
  75.      _////_uuuu_ssss_rrrr_////_llll_iiii_bbbb_////_llll_oooo_cccc_aaaa_llll_eeee_////_l_o_c_a_l_e_////_LLLL_CCCC______MMMM_EEEE_SSSS_SSSS_AAAA_GGGG_EEEE_SSSS_////_uuuu_xxxx_dddd_ffff_mmmm
  76.           language-specific message file (see _LLLL_AAAA_NNNN_GGGG on _eeee_nnnn_vvvv_iiii_rrrr_oooo_nnnn(5)
  77.  
  78. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  79.      _bbbb_ffff_ssss(1), _cccc_ssss_pppp_llll_iiii_tttt(1), _ssss_tttt_aaaa_tttt_vvvv_ffff_ssss(2)
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.